<?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content=
    "application/xhtml+xml; charset=iso-8859-1" />
    <title>
      XScreenSaver-5.43
    </title>
    <link rel="stylesheet" type="text/css" href="../stylesheets/lfs.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.79.1" />
    <link rel="stylesheet" href="../stylesheets/lfs-print.css" type=
    "text/css" media="print" />
  </head>
  <body class="blfs" id="blfs-9.1">
    <div class="navheader">
      <h4>
        Beyond Linux<sup>�</sup> From Scratch <span class="phrase">(System
        V</span> Edition) - Version 9.1
      </h4>
      <h3>
        Chapter&nbsp;41.&nbsp;Other X-based Programs
      </h3>
      <ul>
        <li class="prev">
          <a accesskey="p" href="xdg-utils.html" title=
          "xdg-utils-1.1.3">Prev</a>
          <p>
            xdg-utils-1.1.3
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="../multimedia/multimedia.html" title=
          "Multimedia">Next</a>
          <p>
            Multimedia
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="other.html" title=
          "Chapter&nbsp;41.&nbsp;Other X-based Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <h1 class="sect1">
        <a id="xscreensaver" name="xscreensaver"></a>XScreenSaver-5.43
      </h1>
      <div class="package" lang="en" xml:lang="en">
        <h2 class="sect2">
          Introduction to XScreenSaver
        </h2>
        <p>
          The <span class="application">XScreenSaver</span> is a modular
          screen saver and locker for the X Window System. It is highly
          customizable and allows the use of any program that can draw on the
          root window as a display mode. The purpose of <span class=
          "application">XScreenSaver</span> is to display pretty pictures on
          your screen when it is not in use, in keeping with the philosophy
          that unattended monitors should always be doing something
          interesting, just like they do in the movies. However, <span class=
          "application">XScreenSaver</span> can also be used as a screen
          locker, to prevent others from using your terminal while you are
          away.
        </p>
        <p>
          This package is known to build and work properly using an LFS-9.1
          platform.
        </p>
        <h3>
          Package Information
        </h3>
        <div class="itemizedlist">
          <ul class="compact">
            <li class="listitem">
              <p>
                Download (HTTP): <a class="ulink" href=
                "https://www.jwz.org/xscreensaver/xscreensaver-5.43.tar.gz">https://www.jwz.org/xscreensaver/xscreensaver-5.43.tar.gz</a>
              </p>
            </li>
            <li class="listitem">
              <p>
                Download MD5 sum: aa856bce076e58b021bfc0295fdc45e1
              </p>
            </li>
            <li class="listitem">
              <p>
                Download size: 26 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated disk space required: 249 MB
              </p>
            </li>
            <li class="listitem">
              <p>
                Estimated build time: 1.0 SBU
              </p>
            </li>
          </ul>
        </div>
        <h3>
          XScreenSaver Dependencies
        </h3>
        <h4>
          Required
        </h4>
        <p class="required">
          <a class="xref" href="../x/libglade.html" title=
          "libglade-2.6.4">libglade-2.6.4</a> and <a class="xref" href=
          "../x/x7app.html" title="Xorg Applications">Xorg Applications</a>
        </p>
        <h4>
          Recommended
        </h4>
        <p class="recommended">
          <a class="xref" href="../x/glu.html" title=
          "GLU-9.0.1">GLU-9.0.1</a>
        </p>
        <h4>
          Optional
        </h4>
        <p class="optional">
          <span class="phrase"><a class="ulink" href=
          "http://ftp.gnome.org/pub/gnome/sources/gdm/">GDM</a></span> ,
          <a class="ulink" href="http://linas.org/gle/">GLE</a> and <a class=
          "xref" href="../postlfs/linux-pam.html" title=
          "Linux-PAM-1.3.1">Linux-PAM-1.3.1</a>
        </p>
        <h4>
          Optional (runtime)
        </h4>
        <p class="optional">
          The adobe-100dpi font, with libXfont and bdftopcf from <a class=
          "xref" href="../x/x7legacy.html" title="Xorg Legacy">Xorg Legacy
          Fonts</a> (to enlarge the splash screen, error messages, and
          password prompt)
        </p>
        <p class="usernotes">
          User Notes: <a class="ulink" href=
          "http://wiki.linuxfromscratch.org/blfs/wiki/xscreensaver">http://wiki.linuxfromscratch.org/blfs/wiki/xscreensaver</a>
        </p>
      </div>
      <div class="installation" lang="en" xml:lang="en">
        <h2 class="sect2">
          Installation of XScreenSaver
        </h2>
        <p>
          First, remove some C++ comments from C code that prevents one file
          from compiling:
        </p>
        <pre class="userinput">
<kbd class="command">sed -i '/^\/\//d' hacks/fontglide.c</kbd>
</pre>
        <p>
          Change a harcoded library name, which prevents using the settings
          found by <span class="command"><strong>configure</strong></span>:
        </p>
        <pre class="userinput">
<kbd class="command">sed -i 's/-lsystemd/-lelogind/' driver/Makefile.in</kbd>
</pre>
        <p>
          Install <span class="application">XScreenSaver</span> by running
          the following commands:
        </p>
        <pre class="userinput">
<kbd class="command">./configure --prefix=/usr &amp;&amp;
make</kbd>
</pre>
        <p>
          This package does not come with a test suite.
        </p>
        <p>
          Now, as the <code class="systemitem">root</code> user:
        </p>
        <pre class="root">
<kbd class="command">make install</kbd>
</pre>
      </div>
      <div class="commands" lang="en" xml:lang="en">
        <h2 class="sect2">
          Command Explanations
        </h2>
        <p>
          <code class="option">--with-setuid-hacks</code>: This switch allows
          some demos to be installed setuid <code class=
          "systemitem">root</code> which is needed in order to ping other
          hosts.
        </p>
      </div>
      <div class="configuration" lang="en" xml:lang="en">
        <h2 class="sect2">
          Configuring XScreenSaver
        </h2>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3">
            <a id="xscreensaver-config" name="xscreensaver-config"></a>
          </h3>
          <h4 class="title">
            <a id="xscreensaver-config" name="xscreensaver-config"></a>Config
            Files
          </h4>
          <p>
            <code class="filename">/etc/X11/app-defaults/XScreenSaver</code>
            and <code class="filename">~/.xscreensaver</code>
          </p>
        </div>
        <div class="sect3" lang="en" xml:lang="en">
          <h3 class="sect3"></h3>
          <h4 class="title">
            <a id="idm45779237820640" name="idm45779237820640"></a>Linux PAM
            Configuration
          </h4>
          <p>
            If <span class="application">XScreenSaver</span> has been built
            with <span class="application">Linux PAM</span> support, you need
            to create a <span class="application">PAM</span> configuration
            file, to get it working correctly with BLFS.
          </p>
          <p>
            Issue the following commands as the <code class=
            "systemitem">root</code> user to create the configuration file
            for <span class="application">Linux PAM</span>:
          </p>
          <pre class="root">
<kbd class="command">cat &gt; /etc/pam.d/xscreensaver &lt;&lt; "EOF"
<code class="literal"># Begin /etc/pam.d/xscreensaver

auth    include system-auth
account include system-account

# End /etc/pam.d/xscreensaver</code>
EOF</kbd>
</pre>
        </div>
      </div>
      <div class="content" lang="en" xml:lang="en">
        <h2 class="sect2">
          Contents
        </h2>
        <div class="segmentedlist">
          <div class="seglistitem">
            <div class="seg">
              <strong class="segtitle">Installed Programs:</strong>
              <span class="segbody">xscreensaver, xscreensaver-command,
              xscreensaver-demo, xscreensaver-getimage,
              xscreensaver-getimage-file, xscreensaver-getimage-video,
              xscreensaver-gl-helper and xscreensaver-text</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Libraries:</strong>
              <span class="segbody">None</span>
            </div>
            <div class="seg">
              <strong class="segtitle">Installed Directories:</strong>
              <span class="segbody">/usr/libexec/xscreensaver and
              /usr/share/xscreensaver</span>
            </div>
          </div>
        </div>
        <div class="variablelist">
          <h3>
            Short Descriptions
          </h3>
          <table border="0" class="variablelist">
            <colgroup>
              <col align="left" valign="top" />
              <col />
            </colgroup>
            <tbody>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-prog" name=
                    "xscreensaver-prog"></a><span class="term"><span class=
                    "command"><strong>xscreensaver</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a screen saver and locker daemon.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-command" name=
                    "xscreensaver-command"></a><span class=
                    "term"><span class="command"><strong>xscreensaver-command</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    controls a running <span class=
                    "command"><strong>xscreensaver</strong></span> process by
                    sending it client messages.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-demo" name=
                    "xscreensaver-demo"></a><span class="term"><span class=
                    "command"><strong>xscreensaver-demo</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a graphical front-end for setting the parameters used
                    by the background <span class=
                    "command"><strong>xscreensaver</strong></span> daemon.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-getimage" name=
                    "xscreensaver-getimage"></a><span class=
                    "term"><span class=
                    "command"><strong>xscreensaver-getimage</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a helper program for the <span class=
                    "command"><strong>xscreensaver</strong></span> modules
                    that manipulate images.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-getimage-file" name=
                    "xscreensaver-getimage-file"></a><span class=
                    "term"><span class=
                    "command"><strong>xscreensaver-getimage-file</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a helper program for the <span class=
                    "command"><strong>xscreensaver</strong></span> modules
                    that manipulate images.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-getimage-video" name=
                    "xscreensaver-getimage-video"></a><span class=
                    "term"><span class=
                    "command"><strong>xscreensaver-getimage-video</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a helper program for the <span class=
                    "command"><strong>xscreensaver</strong></span> modules
                    that manipulate images.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-gl-helper" name=
                    "xscreensaver-gl-helper"></a><span class=
                    "term"><span class=
                    "command"><strong>xscreensaver-gl-helper</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    is a helper program for the <span class=
                    "command"><strong>xscreensaver</strong></span> OpenGL
                    modules.
                  </p>
                </td>
              </tr>
              <tr>
                <td>
                  <p>
                    <a id="xscreensaver-text" name=
                    "xscreensaver-text"></a><span class="term"><span class=
                    "command"><strong>xscreensaver-text</strong></span></span>
                  </p>
                </td>
                <td>
                  <p>
                    prints some text to stdout, for use by screen savers.
                  </p>
                </td>
              </tr>
            </tbody>
          </table>
        </div>
      </div>
      <p class="updated">
        Last updated on 2020-02-16 15:50:16 -0800
      </p>
    </div>
    <div class="navfooter">
      <ul>
        <li class="prev">
          <a accesskey="p" href="xdg-utils.html" title=
          "xdg-utils-1.1.3">Prev</a>
          <p>
            xdg-utils-1.1.3
          </p>
        </li>
        <li class="next">
          <a accesskey="n" href="../multimedia/multimedia.html" title=
          "Multimedia">Next</a>
          <p>
            Multimedia
          </p>
        </li>
        <li class="up">
          <a accesskey="u" href="other.html" title=
          "Chapter&nbsp;41.&nbsp;Other X-based Programs">Up</a>
        </li>
        <li class="home">
          <a accesskey="h" href="../index.html" title=
          "Beyond Linux� From Scratch     (System V Edition) - Version 9.1">Home</a>
        </li>
      </ul>
    </div>
  </body>
</html>
